home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / proana74.zip / PROANA.DOC next >
Text File  |  1992-08-27  |  46KB  |  1,112 lines

  1.  
  2.  
  3.  
  4.         
  5.         
  6.         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.         
  14.         
  15.         
  16.                               
  17.         
  18.         
  19.         
  20.         
  21.         
  22.         
  23.         
  24.                               Professional Analyzer
  25.                                    for RBBS-PC
  26.                                         
  27.                                 Version 17.4 - 05
  28.                                         
  29.                                         
  30.         
  31.         
  32.         
  33.                                By: Charles Doughty
  34.                             Capitol City Gateway RBBS
  35.                            (916)-381-8788 USR HST 9600
  36.                      RBBS-Net 8:914/301  FIDO-Net 1:203/909
  37.                                         
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.         
  46.         
  47.         
  48.         
  49.         
  50.         
  51.         
  52.         
  53.         
  54.         
  55.         
  56.         
  57.         
  58.         
  59.                              ProAna For RBBS Ver. 17.4
  60.  
  61.  
  62.         
  63.         
  64.                                    Table of Contents
  65.                 <CTRL> V  at the main menu will give you TRUE version #
  66.         
  67.         
  68.             Description of ProAna....................................   1
  69.         
  70.             Why Do You Need the Professional Analyzer?...............   1
  71.         
  72.             Starting Out.............................................   1
  73.         
  74.             Bringing up ProAna.......................................   2
  75.         
  76.             Configuring ProAna.......................................   2
  77.         
  78.             The Main Menu............................................   3
  79.         
  80.             Analyzing the Callers File...............................   3
  81.         
  82.             Creating a Report........................................   4
  83.         
  84.             Site Selected Statistics.................................   5
  85.         
  86.             Analyzing the Messages File..............................   6
  87.         
  88.             Analyzing the Users File.................................   6
  89.         
  90.             The PROSTATE.TBL File....................................   7
  91.         
  92.             The User Editor..........................................   7
  93.         
  94.             You Found a Problem?.....................................   8
  95.         
  96.             Limited Warranty.........................................   8
  97.         
  98.             Distribution.............................................   8
  99.         
  100.             Registration.............................................   8
  101.         
  102.             Appendix A: Automated Reports............................  10
  103.         
  104.             Appendix B: Report information...........................  12
  105.         
  106.             Appendix C: Revision History.............................  14
  107.         
  108.             Important Notes..........................................  15
  109.         
  110.         
  111.         
  112.         
  113.         
  114.         
  115.         
  116.         
  117.                              ProAna For RBBS Ver. 17.4
  118.  
  119.  
  120.         
  121.                                         i
  122.         
  123.         ======> Description of ProAna
  124.         
  125.              The Professional Analyzer (ProAna) is a tool used to 
  126.         give access to important and interesting statistics when running 
  127.         a bulletin board.  Information such as when the most people 
  128.         call during the day, how many people use a particular protocol, 
  129.         and other data... such as how many people read your bulletins 
  130.         on various subjects, are included in the reports.
  131.         
  132.         ======> Why Do You Need the Professional Analyzer?
  133.         
  134.              Well, of course if you don't run a RBBS-PC bulletin board I 
  135.         can't give you any reasons, but if you do.... ProAna is a produc-
  136.         tivity tool.  Let's say you run a BBS for your company and you 
  137.         need to know how many out-of-state users you have.  Now, with 
  138.         ProAna you'd simply hit F4 at the main menu and, in seconds you 
  139.         would receive a complete breakdown of how many users you have 
  140.         from each state.  Or if you are a SYSOP who is contemplating 
  141.         purchasing a 9600 bps modem, and you have borrowed one from a 
  142.         friend for a week and put it on-line. After that week, you can 
  143.         use the Callers File analyzer to see how many people actually 
  144.         used the 9600 bps, and then make your decision based on that. 
  145.         Another case would be if you were a SYSOP Beta testing a new 
  146.         version of RBBS-PC that has some minor fixes when suddenly RBBS 
  147.         starts trashing every user who answers a questionairre.  (Of 
  148.         course with RBBS this would NEVER happen!) Luckily, you caught 
  149.         the bug after only one user got trashed, but now that user's 
  150.         defaults are all messed up.  Again, with Proana you can edit 
  151.         almost every field and reset everything to normal.
  152.              As you can see, the possibilities for ProAna are limitless!
  153.         
  154.         ======> Starting Out
  155.         
  156.              ProAna is very easy to install.  All you have to do is copy 
  157.         ProAna's' working files to ANY directory of your Hard Disk and 
  158.         run it.  The files required are PROANA.EXE, the main program, 
  159.         PROCALL.EXE, the callers file analyzer, PROSTATE.TBL, the table 
  160.         that includes states and common abbreviations, PROCALL.CTL, a 
  161.         file that includes special site-selected statistics.  (This file 
  162.         is optional.) and PROTO.DEF (a RBBS-PC file). 
  163.              If you would like to install ProAna to another directory 
  164.         than C:\RBBS then you would have to add that directory to your 
  165.         path statement, and set the environment variable "PROANA".  If 
  166.         your RBBS files are in "C:\RBBS" and you would  like to run 
  167.         ProAna in "C:\RBBS\PROANA", you just add C:\RBBS\PROANA to your 
  168.         path statement and add the line "SET PROANA=C:\RBBS\PROANA" to 
  169.         your autoexec.bat on a separate line.  This will tell ProAna 
  170.         where to find it's files.  But more on that shortly!
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                         1
  178.                              ProAna For RBBS Ver. 17.4
  179.  
  180.  
  181.         
  182.         ======> Bringing up ProAna
  183.         
  184.         To bring up ProAna you enter the command:
  185.         
  186.                          C>proana #
  187.         
  188.         where '#' is the number of the node that you want to analyze or 
  189.         edit. '#' must be a valid integer from 1 through 36.  If '#' is 
  190.         not included, or is invalid, ProAna will assume node #1 for 
  191.         convenience.  Once you have started ProAna, you will see an 
  192.         introductory screen that can be cleared by pressing any key.  If 
  193.         this is the first time running ProAna on a particular node, you 
  194.         will not get the introductory screen until you have configured 
  195.         ProAna.
  196.         
  197.         
  198.         ======> Configuration
  199.         
  200.         WARNING:  Use full path and names for all files in ProAna Config-
  201.         uration items.  Do NOT use implicit paths.  (i.e.: Use 
  202.         C:\RBBS\NODE1\CALLERS and not NODE1\CALLERS.)
  203.         
  204.              Before you can use ProAna, you must tell it a few things.  
  205.         First, you need to let it know what type of monitor you are 
  206.         using.  The default choice is "M" for monochrome, and if that is 
  207.         correct, you should press the down arrow to continue.  (2 on the 
  208.         numeric keypad.)  If you are using a color card and color moni-
  209.         tor, you should first change that value to a "C", and then DO NOT 
  210.         press the down arrow.  ProAna will advance you to the next field 
  211.         automatically.
  212.         
  213.              After you have specified your monitor type, you must specify 
  214.         the name of your RBBS Callers file as specified in Config parame-
  215.         ter #90.  This may be any fully qualified path name up to 26 
  216.         characters long.
  217.         
  218.              Then after you enter the Callers file path and name, you 
  219.         must advance to the next field and enter the RBBS Messages file 
  220.         name. This is the same file that is described in parameter #86 of 
  221.         Config.
  222.         
  223.              The next field is the name of RBBS's Users file. This should 
  224.         be the same as the file specified in parameter #87 of Config.
  225.         
  226.              Following the Users file name, is the name of the ".DEF" 
  227.         file that RBBS uses.  This will be "RBBSxPC.DEF" where 'x' is 
  228.         node-number or a '-' for non-multiple node operations, by default 
  229.         in RBBS.  Otherwise, if you use a special name  for the ".DEF" 
  230.         file, you must specify that.
  231.         
  232.              Next is the name of the file that ProCall (the  call analy-
  233.         sis program) uses when you O)utput a report.  This can be any 
  234.         name, including the name of the bulletin where the SYSOP keeps 
  235.         his RBBS stats.  Following this, are the names of the dates 
  236.  
  237.  
  238.                                         2
  239.                              ProAna For RBBS Ver. 17.4
  240.  
  241.  
  242.         between which ProAna will analyze in the Callers file.
  243.         
  244.              These must be numeric, and the default is the whole file, by 
  245.         specifying dates which are out of range.
  246.         
  247.              Now, the next two fields, are the names of the files where 
  248.         the user file report and messages file report will be output to.
  249.         
  250.              The next field will ask you if you want standard windows or 
  251.         the pop open / exploding window type menus.
  252.         
  253.              The last option to configure will be the full path and 
  254.         extension for the output of the various single screen reports 
  255.         that ProAna will output for you in the form of single screen 
  256.         bulletins.
  257.         
  258.              Once you are finished, if everything is correct, hit the 
  259.         {ESC} key, and respond "Y" to the question "Save Configuration 
  260.         File <Y/N>?".
  261.         
  262.              As you can see when the screen comes up, there are defaults, 
  263.         and if those suit your particular configuration by chance, you 
  264.         may just press {ESC} and save it.
  265.         
  266.         ======> The Main Menu
  267.         
  268.              After you have brought up ProAna, if you have run it before, 
  269.         you will be given a Main Menu to choose from. The options avail-
  270.         able are:
  271.         
  272.                                 F1 - Configuration
  273.                                 F2 - Analyze Callers file
  274.                                 F3 - Analyze Messages file
  275.                                 F4 - Analyze Users file
  276.                                 F5 - Edit Users file
  277.                                ESC - Quit to DOS
  278.         
  279.              You can select any option by pressing the related function 
  280.         key.  (E.g.  F1 will select the Configuration sub-program.)  If 
  281.         you HAVEN'T run ProAna before, you will be given a message saying 
  282.         that ProAna is creating the necessary CONFIG files, and you will 
  283.         then be presented with a configuration screen, which is described 
  284.         above.
  285.         
  286.         ======> Analyzing the CALLERS file
  287.         
  288.              One of the most important functions of ProAna is the analy-
  289.         sis of the callers file.  This provides a vast source of informa-
  290.         tion, commonly displayed in two or more methods.  To analyze the 
  291.         callers file, you must, from the Main Menu, push the "F2" key 
  292.         which starts the separate analysis program.  It will take a 
  293.         little while for it to get loaded, depending on your particular 
  294.         configuration.
  295.         
  296.              First, after having selected "F2" and ProCall (the name of 
  297.  
  298.  
  299.                                         3
  300.                              ProAna For RBBS Ver. 17.4
  301.  
  302.  
  303.         the call analysis program) having been loaded, you will see a 
  304.         display  similar  to  this:
  305.         
  306.         
  307.             ┌───────────────────────────────────────────────────────────┐
  308.             │   Buffer Size                   Date:       Time:         │
  309.             │    128                          06-30-1989  14:15:34      │
  310.             │   /                                       \/              │
  311.             │  1                                        2               │
  312.             │                                                           │
  313.             │                                                           │
  314.             │   Control Strings    Records    1st Logon  Last Logon     │
  315.             │                4      1858    5_ 06-27-89   06-30-89 _6   │
  316.             │              /       /1800     \ 12:48 PM   12:22 AM /    │
  317.             │             3       4     \                7              │
  318.             │                            8    Start Date/ \End Date     │
  319.             │                                 01-01-1980   12-31-1999   │
  320.             └───────────────────────────────────────────────────────────┘
  321.  
  322.                          1) Buffer Size for CALLERS file
  323.                          2) Current Date & Time
  324.                          3) Number of strings in PROCALL.CTL file
  325.                          4) Number of records in CALLERS file
  326.                          5) Time & Date of 1st logon in CALLERS file
  327.                          6) Time & Date of last logon in CALLERS file
  328.                          7) Start & End date of range to analyze
  329.                          8) Number of records left to search in
  330.                                    increments of 100.
  331.         
  332.              NOTE: After ProCall is finished reading the CALLERS file, it 
  333.         will begin sorting.  A note will be displayed in front of #8 to 
  334.         that effect.
  335.         
  336.              Once the loading process is finished,  ProCall will then 
  337.         display a menu of options that you may display.  First, you can 
  338.         return to this menu at any time by pressing "F1".   Second, you 
  339.         can look at the numbers and totals for all the stats by selecting 
  340.         "F2", or you can go right into it by pressing "+".
  341.         
  342.              There are several pages of data tied to the F1 Charts, the 
  343.         "+" and "-" keys navigate through them. On the right while dis-
  344.         playing the stats, you will see a list of downloaded files, which 
  345.         can be navigated by  using the  "PgDn" or "3" on the numeric  
  346.         keypad, "PgUp" or "9" on  the numeric  keypad, "Home" or "7", 
  347.         "End" or "1", and can be sorted by count by pressing "s".
  348.         
  349.              After the stats come the graphs.  The first graph can be 
  350.         displayed by either pressing "F3" or by paging past the  end of 
  351.         the stats.  (You can page through the whole report by pressing 
  352.         "+" and "-".)  This graph is a breakdown of the number of calls 
  353.         per hour.  This is one of the most important graphs, as it tells 
  354.         when the bulletin board is being used the most.
  355.         
  356.              Other graphs are accessed by pressing the F4 through F7 
  357.         keys.  These graphs should be self explanatory.  Since this is a
  358.  
  359.  
  360.                                         4
  361.                              ProAna For RBBS Ver. 17.4
  362.  
  363.  
  364.         very modified version (in that the code has been greatly econo-
  365.         mized) and several changes have been made AND only minimal BETA 
  366.         testing has been accomplished, please let us know if something 
  367.         needs more explanation.
  368.         
  369.         
  370.         ======> Creating a Report
  371.         
  372.              Another excellent feature of ProCall is the ability to put 
  373.         all these statistics into an easy-to-read, comprehensive report.  
  374.         This report can be formatted for RBBS, the screen, or  printing.
  375.         
  376.              To output a report, you must, after ProCall is loaded, press 
  377.         "o" at any time while displaying graphs, or the Main Menu. (This 
  378.         is as shown on the last couple lines of the display.   As you've 
  379.         probably discovered by now, the last few lines of the display 
  380.         usually have a brief summary of the options  available.) After 
  381.         you select "o" you will be prompted for the type of format you 
  382.         want it outputted for.  You can select "s" for "SCREEN", which 
  383.         works well with text readers such as Vernon Buerg's "List" pro-
  384.         gram, or you can select "p" for "PRINTER", which will format it 
  385.         66 lines/page, and adds extra things here and there.
  386.         
  387.              Finally, you can select "r" for "RBBS" which will output a 
  388.         report based on a screen length of 23, and usually works well 
  389.         with RBBS.  It is a bit different though, depending on where you 
  390.         start showing it, and this is because of RBBS.  For example if 
  391.         you selected "N)ew bulletins" and it displayed it in the context, 
  392.         the page stops would be different then selecting "6" from the 
  393.         bulletin  menu,  and  that  would  be  different than selecting 
  394.         "b;6" from the main menu of RBBS.  New with 15.1C you can also 
  395.         include ANSI color in your RBBS reports, too!
  396.         
  397.              After you have specified the format for the report,  ProCall 
  398.         will begin writing the report to disk and issue a message to that 
  399.         effect.
  400.         
  401.              When you are finished with ProCall, you can press {ESC} to 
  402.         return to the Main Menu of ProAna.
  403.         
  404.         ======> Site Selected Statistics
  405.         
  406.              Occasionally, some SYSOPs will add their own messages that  
  407.         go into the CALLERS log.   Never fear, ProCall has made provi-
  408.         sions for these special statistics!  An optional file you can 
  409.         have in your ProAna directory/disk, is a file by the name of 
  410.         "PROCALL.CTL", which contains control strings to search for, and 
  411.         strings to be displayed on the Site Selected Statistics page of 
  412.         ProCall's stats.  The format of this file is:
  413.         
  414.                      "<SEARCH_STRING>","<DISPLAY_STRING>"
  415.                IE:  "need","Users needing more time to download"
  416.         
  417.         where <SEARCH_STRING> is the string to search on in the CALLERS 
  418.         file, and <DISPLAY_STRING> is the string to be displayed on the      
  419.  
  420.  
  421.                                         5
  422.                              ProAna For RBBS Ver. 17.4
  423.  
  424.  
  425.         screen.  You can have up to 19 site-selected statistics, the 
  426.         search string can be up to 20 characters long, and the displayed 
  427.         string can be no longer than 25 characters long.  This file must 
  428.         be created using an ASCII editor, and must contain the double 
  429.         quotation marks ('"') and the commas.  (',')
  430.         
  431.         ======> Analyzing the Messages File
  432.         
  433.              The MESSAGES file analysis routine can be reached by press-
  434.         ing "F3" from the Main Menu of ProAna.  It will take only a few 
  435.         seconds to load, depending on the size of your MESSAGES file. 
  436.         After loading, a report will be written to a file as named in
  437.         the PROANA CONFIG file.
  438.         
  439.              This is one of the easiest routines to execute in the whole 
  440.         package, as there are no prompts, almost no waits, and only one 
  441.         screen.  So, the documentation for this one will be brief.   The 
  442.         routine will display various information concerning RBBS's MES-
  443.         SAGES  file, including how many nodes are sharing it, the number 
  444.         of killed messages, the number of active messages, the number of  
  445.         kill protected messages, the number of receiver protected mes-
  446.         sages, the number of password protected messages, the average 
  447.         number of records required by each message, and the list goes on 
  448.         and on.  If you use elastic message bases some of the numbers may 
  449.         appear to be in error, but the program is using the information 
  450.         from RBBS-PC.DEF so it can't tell properly what the size of the 
  451.         file should be.
  452.         
  453.              Some of the more confusing numbers are the statistics on the 
  454.         right column of the screen.  When ProAna says "Record Number", it 
  455.         means "Record Number"!  The "Record Number" is the actual record 
  456.         number where RBBS gets the certain statistic.  To exit this sub-
  457.         routine, like the others, press {ESC} and  you will be returned 
  458.         to ProAna's Main Menu.  No key presses are needed here, ever and 
  459.         it will output a message report automatically!
  460.         
  461.         ======> Analyzing the User File
  462.         
  463.              To analyze RBBS's USERS file, press "F4" from ProAna's  Main 
  464.         Menu.   As with the MESSAGES file analyzer, this routine is 
  465.         fairly simple, and takes a few seconds to load.  After it is 
  466.         loaded, the list of states described later on will be shown on 
  467.         the display, and ProAna will start analyzing the USERS file.  The 
  468.         lower box on the screen shows ProAna's progress, including the 
  469.         number of users found, and the number not found unless you have 
  470.         set the PROSTATE.TBL file to generate a bulletin as discussed 
  471.         later.  No key presses are needed here and it will generate the 
  472.         report automatically to a file named in your PROANA CONFIG file.
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.                                         6
  484.                              ProAna For RBBS Ver. 17.4
  485.  
  486.  
  487.         ======> The PROSTATE.TBL File
  488.         
  489.              Required by ProAna's user analysis routine is a file called 
  490.         "PROSTATE.TBL" which must exist in the same drive/directory as 
  491.         ProAna.  This file can have up to 60 entries in the following 
  492.         format.
  493.         
  494.                         ST/LONG STATE NAME/CITY/CITY/CITY...etc.
  495.         
  496.         where "ST" is the 2-character abbreviation for the 
  497.         state/country/providence, "LONG STATE NAME" is the full name of 
  498.         the state, and "CITY" is any number of cities in the state.  The 
  499.         only required field is "ST", which is displayed on the screen and 
  500.         searched for.  The other fields are used to cut down on the 
  501.         number of exceptions because occasionally users specify a city, 
  502.         and no state, or a long name for a state...etc.  These fields all 
  503.         must be in CAPITAL LETTERS.  If you put "**/" as the first line 
  504.         in your PROSTATE.TBL the report will instead of listing the 
  505.         exceptions, list just the number of users found for each 
  506.         state/country/province.  The PROSTATE.TBL comes without "**/" in 
  507.         the first line.  "*c/" is the same as  "**/" except the "c" will
  508.         cause the report to be generated in COLOR.
  509.         
  510.         ======> The User Editor
  511.         
  512.              One of the most convenient features of ProAna is the ability 
  513.         to edit almost all of the fields in the user record.  This would 
  514.         be handy if, for example, a user moved.  The SYSOP could then 
  515.         start the user editor by pressing "F5" from the Main Menu,  and 
  516.         change the user's city, state, and individuation (if needed).  
  517.         The keys used in the User Editor are similar to the keys in the 
  518.         configuration editor, with the following exceptions.  "Home" is 
  519.         used mainly to verify the subscription dates on the second page, 
  520.         but will also change the color (from green to cyan if on a color 
  521.         display) of the fields on the second page.  "PgDn" is used to get 
  522.         to the second page from the first, and "PgUp" is used to return 
  523.         to the first page.  You may match on a partial name here, there 
  524.         is no need to remember or type the whole name.
  525.         
  526.              The only fields that aren't editable in the user editor are 
  527.         the "NAME" and "LAST DATE & TIME ON" fields.  ("LAST DATE & TIME 
  528.         ON" will be editable in a later version.)
  529.         
  530.              You can change the fields to just about anything you want 
  531.         to, within the realm of reality.  For example, you can't set the 
  532.         page length to "hg" or the subscription date to "22-40-1943".  
  533.         One note: The fields in bright white on a color display are NOT 
  534.         editable.  And they can't be eaten either.
  535.         
  536.              The individuation field is the 19 compressed bytes that were
  537.        formerly used for "Machine Type" on older versions of RBBS-PC
  538.        starting at position 87 and extending to 105 in the user record.
  539.         
  540.  
  541.  
  542.  
  543.  
  544.  
  545.                                         7
  546.                              ProAna For RBBS Ver. 17.4
  547.  
  548.  
  549.         ======> You Found a Problem?
  550.         
  551.              If something is not working as documented, or ProAna will 
  552.         not work in your particular configuration, I'd like to hear about 
  553.         it!  You can call my board anytime.......... 24 hours a day and 
  554.         leave a message.  Optionally you can send Echo Mail to me at Fido 
  555.         Net 1:203/909 or RBBSNET at 8:914/301.  I am not promising any-
  556.         thing, just that I will try and do what I can for you. Registered
  557.         users will receive a voice support phone number.
  558.         
  559.         ======> Limited Warranty
  560.         
  561.              The warranty is VERY limited...  There isn't one!!  These 
  562.         programs are provided  "as is", without any  warranty of any  
  563.         kind,  either  expressed  or  implied,  including,  but not 
  564.         limited to the implied warranties of merchantability and fitness 
  565.         for a particular purpose.  The entire risk as to the quality and 
  566.         performance of these programs is with  you.  I do not warrant 
  567.         that the functions contained in these programs will suit  your 
  568.         needs or that the operation of these programs will be uninter-
  569.         rupted or error free.
  570.         
  571.         ======> Distribution
  572.         
  573.              This program may be freely distributed.  Please distribute 
  574.         this program at User Groups, and your favorite bulletin boards.  
  575.         No charge may be made for this program other than actual costs 
  576.         for duplicating the disk.
  577.         
  578.              If you use this program, and would like more of it's kind, 
  579.         please consider sending a small contribution of just $20.00 to 
  580.         the following address.  The price of this program has been kept 
  581.         to such a low fee because of the understanding of the time, 
  582.         effort, and financial sacrifice that have gone into a BBS.
  583.         
  584.         =====>> Please send all registrations to:
  585.         
  586.                             The Capitol City Gateway
  587.                                Mail Stop - ProAna
  588.                                    BOX  60550
  589.                              Sacramento, California
  590.                                    95860-0550
  591.         
  592.         
  593.         There are many benefits involved if you register, including:
  594.                         - RBBS-PC support on the author's bulletin
  595.                                   board(s). 24 Hrs, 7 days a week.
  596.                         - You will receive notice every time a new
  597.                                   version of ProAna is available.
  598.                         - Registered users are considered serious
  599.                                   users and your comments and suggestions
  600.                                   are given top priority.
  601.         
  602.                         - A voice help line number for Registered users.
  603.                 You can contact me at  the following RBBS systems in the
  604.                 Golden State of California:
  605.  
  606.                                    Capitol City Gateway RBBS
  607.  
  608.  
  609.                                         8
  610.                              ProAna For RBBS Ver. 17.4
  611.  
  612.  
  613.                                         (916) 381-8788
  614.                                       The board now runs
  615.                                 24 hours a day, 14,400 Baud (HST)
  616.         
  617.              The latest version of ProAna will always be available on the 
  618.         board, and I will try to keep the latest on Jon Martin's, Ken
  619.         Goosens's, Doug Azzarito's and John Morrison's RBBS Systems.
  620.         
  621.              Thank you for your support! Happy analyzing!
  622.         
  623.                                                  Charles Doughty
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.                                         9
  671.                              ProAna For RBBS Ver. 17.4
  672.  
  673.  
  674.         
  675.                 Appendix A: Automated Reports
  676.         
  677.              A feature added in version  15.1C of ProAna is the  ability 
  678.         to automatically produce  reports from  the command  line.  You 
  679.         can produce a report from ProCall only, OR you can produce a  
  680.         global reports analyzing  the callers  file, messages  file, and  
  681.         users file.
  682.         
  683.              The syntax for producing a report is quite simple.   Basi-
  684.         cally it is as follows:
  685.         
  686.             C>proana <node> <type> <start_date> <end_date> <output_fmt>
  687.         
  688.             Where:
  689.            <node>  The node number your wish to analyze for. ProAna
  690.                    will use the correct PROANA.CFx file.
  691.         
  692.            <type>  The type of report you wish to output. Either
  693.                    "-g" for a G)lobal report, or "-o" for O)nly
  694.                    the callers file analysis.
  695.         
  696.            <start_date>  The ProCall START DATE for outputting the
  697.                          report. The dates should be strictly numeric
  698.                          using no hyphens or slashes.
  699.         
  700.            <end_date>  The ProCall END DATE for outputting the report.
  701.                        As above, no "-" or "/" should be included.
  702.         
  703.            <output_fmt>  The format the ProCall report will take.
  704.                          This is in the form of an option:
  705.         
  706.                            /RA = RBBS ANSI Color format
  707.                            /R  = RBBS format
  708.                            /P  = Formatted for output to a printer
  709.                            /S  = Easy to view with such programs as
  710.                                  "LIST" by Vern Buerg.
  711.                            -g  = To use the Global report function,
  712.                                  you must choose "Y" for the last item
  713.                                  in Proana's Config Page (F1 key).
  714.         
  715.         
  716.            An example of this would be:
  717.         
  718.                   C>proana 1 -o 010180 123199 /R
  719.         
  720.              Which would output only the Callers file analysis in RBBS 
  721.         format using the default filename set up on the Configuration 
  722.         procedures.
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                                         10
  732.                              ProAna For RBBS Ver. 17.4
  733.  
  734.  
  735.            From this, a very handy batch file could be made:
  736.         
  737.                 C>copy con:prorept.bat
  738.                  echo off
  739.                  echo Produces a complete ProAna report for node 3!
  740.                  proana 3 -g 010180 123199 /ra
  741.                  copy user.rpt c:\rbbs\bulletin\bullet1c
  742.                  copy user.rpt c:\rbbs\bulletin\bulletc
  743.                  etc.. etc .........
  744.                  echo on
  745.                  ^Z
  746.                          1 file(s) copied
  747.         
  748.         NOTE: Now, as of this version, when making an automatic bulletin 
  749.         using the -0  or -G command line option, you no longer need be 
  750.         there to press the enter key.  The front screen and the last 
  751.         screen are removed and after all bulletins are generated, Proana 
  752.         is exited and control returns to the calling program or batch 
  753.         file. Try editing the included batch file 'RPT2BUL.BAT'.
  754.         
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.                                         11
  791.                              ProAna For RBBS Ver. 17.4
  792.  
  793.  
  794.                 APPENDIX B: Description of Callers Log Analysis
  795.         
  796.         Page 1. This page gives you information on types of connections 
  797.                 to your BBS.  This page will give you the baud rate of 
  798.                 all callers to the BBS, and the total number of callers.  
  799.                 Then it will give you the number that are using either 
  800.                 MNP or V.42, the number of "proper logoffs", dropped 
  801.                 carrier, and sleep disconnects.
  802.         
  803.         Page 2. This page tells you how many security problems you might 
  804.                 have.  Keep in mind that some of the entries here may 
  805.                 very possibly be due to mistakes by users.  All entries 
  806.                 are pretty much self explanatory.
  807.         
  808.         Page 3. Gives you download statistics both for the total amount 
  809.                 of files downloaded, and total number of files.  This 
  810.                 screen also gives you the number of files, and the aver-
  811.                 age number of files per day downloaded by each protocol.  
  812.                 NOTICE - If a particular protocol is not used, it will 
  813.                 not appear here even though you do have it in your 
  814.                 PROTO.DEF.
  815.         
  816.         Page 4. FNMBU or FMDD - File Name Misspelled By User or File 
  817.                 Missing from Download Directory - Means the same as the 
  818.                 old 'File not found!'
  819.         
  820.                 Attempted duplicate upload - Tried to upload a file when 
  821.                 a file of the same name already is on your hard drive.
  822.         
  823.                 ADT - Attempted Download Terminated - User aborted down-
  824.                 load.
  825.         
  826.                 Not enough DL time left - User tried to download a file 
  827.                 that took more time than he had left in the session.
  828.         
  829.         Page 5. System Control Statistics
  830.                 This page will tell you about non-fatal errors that are 
  831.                 generated by RBBS, new users, messages left and read, 
  832.                 door usage, comments left, pages etc.  The comments left 
  833.                 field will not work properly if you have the config 
  834.                 option for comments left as private messages set to yes.  
  835.                 This page will also give you the utilization of your 
  836.                 system.  NOTE - National average percent of utilization 
  837.                 for RBBS is 38%.
  838.                 NOTICE - This page will not give you the same results if 
  839.                 you are using a front end mailer on your system due to 
  840.                 the mailer handling the calls to the system.
  841.         
  842.         Page 6. Bulletin Statistics.  If you use Named bulletins (i.e.. 
  843.                 BUSE) this page will give you the number of times that 
  844.                 the 12 most read bulletins have been read, however if you 
  845.                 use numbered bulletins, it will give you the number of 
  846.                 times that any bulletin has been read.
  847.         
  848.         Page 7. Site Selected Statistics - This will report on the sta-
  849.  
  850.  
  851.                                         12
  852.                              ProAna For RBBS Ver. 17.4
  853.  
  854.  
  855.                 tistics you chose to have included your self.
  856.         
  857.         Page 8. Graphical display of calls received by RBBS per hour.
  858.         
  859.         Page 9. Graphical display of connect rates as reported by your 
  860.                 modem (or front end) to RBBS.
  861.         
  862.         Page 10.Graphical display of the first twelve protocols used as 
  863.                 listed in your PROTO.DEF.  This will not show protocols 
  864.                 that are not used.
  865.         
  866.         Page 11.Graphical display of total system time up, system time 
  867.                 idle, and system time used.  National AVG. is 38% used.
  868.                 (According to a poll of over 350 RBBS-PC systems)
  869.         
  870.         Page 12.Graphical display of methods of leaving RBBS.  Carrier 
  871.                 drops also includes voice calls, calls where carrier is 
  872.                 not detected, and people who hang up on RBBS rather than 
  873.                 using the "G" command.
  874.         
  875.         Page 13.Who uploaded files during the time you are analyzing.  
  876.                 This will list the file names and tell you who uploaded 
  877.                 the file using the name in the users file.  NOTE - Files 
  878.                 uploaded by the SysOp will not show the sysop's private 
  879.                 name, but will show Upld by: ==> SYSOP.
  880.         
  881.         Page 14.Two column display of files sorted alphabetically in the 
  882.                 first column, and sorted by the number of times it has 
  883.                 been downloaded in the second column.  This will allow 
  884.                 you to determine if a file is not being downloaded, and 
  885.                 also allow you to see what the most popular files on your 
  886.                 BBS are.
  887.         
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.                                         13
  914.                              ProAna For RBBS Ver. 17.4
  915.  
  916.  
  917.                 Appendix C: Revision History
  918.         
  919.         15.1B-01 - First shareware release of ProAna. Originally
  920.                    called 'CALLANA'. (07-07-87)
  921.         
  922.                    "Rel. 2.2" Was a  temporary "bug  fixing"  release 
  923.                    which corrected problems  with 9600  bps and other 
  924.                    minor errors. (07-16-87)
  925.         
  926.         15.1C-01 - Released corresponding with RBBS 15.1C, and includes 
  927.                    such features as automated  reports, and  color re-
  928.                    ports.   Also  fixes a few bugs found in previous 
  929.                    versions. (11-15-87)
  930.         
  931.         16.1A-01 - Loren Jones & Andrew Hoag now responsible for updating 
  932.                    the code, Jerry Sanders no longer is involved with or 
  933.                    using RBBS-PC itself.  Again  released on the  same 
  934.                    date as  RBBS-PC 16.1A, and includes  full support of  
  935.                    RBBS-PC 16.1A's features.  Bugs were  fixed, and  the 
  936.                    user file editor  now uses the  PASSWRDS file to 
  937.                    determine subscription length. (03-20-88)
  938.         
  939.         
  940.         17.3A-01 - Charles Doughty takes over the responsibilities for 
  941.                    re-writing the code, making changes and updating each 
  942.                    version to coincide with RBBS-PC releases. Updated to 
  943.                    reflect the most recent version of RBBS-PC.  Many 
  944.                    deletions and additions.  Some bugs fixed, now runs 
  945.                    slightly faster.  Major changes to the output charts.  
  946.                    Major portions of the code  rewritten to  compile 
  947.                    under a newer / different compiler.   (08-11-89)
  948.         
  949.         
  950.         17.3A-04 - Now requires the Sysop to use a PROTO.DEF file.  
  951.                    PROANA now reads the PROTO.DEF file to format several 
  952.                    reports.  This allows the Sysop to do as he pleases 
  953.                    with his download/upload protocols.  Ver. 17.3A-01 
  954.                    required a standard PROTO.DEF and may have restricted 
  955.                    Sysops in some ways. (09-11-89)
  956.         
  957.         17.3A-07 - Final version until RBBS-PC Ver 18 comes out.  Allows 
  958.                    file share using the DOS SHARE command.  All bugs 
  959.                    fixed?  New feature added tells Who Uploaded What 
  960.                    files.  (Apr.-19-90)
  961.         
  962.         17.4 -02 - Maybe really final version before Ver 18 comes out. 
  963.                    Fixed minor bugs. Updated to allow reading of the new 
  964.                    RBBS-PC features. 10% reduction in the size of 
  965.                    PROANA.EXE due to more re-writing of the code. Color 
  966.                    changes & clean-up. Faster than the previous version. 
  967.                    Reads up to 16,000 baud now, Puts Sysops REAL name
  968.                    instead of LOG-on name in the WHO UPLOADED WHAT file 
  969.                    listing and much more!  Individual reports are now
  970.                    generated instead of just one long report. (July-29-1992)
  971.         
  972.         
  973.         
  974.  
  975.  
  976.                                         14
  977.                              ProAna For RBBS Ver. 17.4
  978.  
  979.  
  980.         
  981.                                     IMPORTANT NOTES
  982.         
  983.         
  984.                With this version of PROANA, a PROTO.DEF file is required 
  985.         if you want download stats and charts.  However, differing from 
  986.         PROANA version 17.3A-04, this version allows the sysop to use any 
  987.         PROTO.DEF and not a standardized one!  PROANA reads the PROTO.DEF 
  988.         file and uses that info to search the callers file and 
  989.         format/display the stats and charts.  You will notice that on the 
  990.         stat page showing downloads, that ONLY the protocols that are 
  991.         actually used are shown on the page.  This is because there are 
  992.         only 15 lines on that page available for these stats and some 
  993.         proto.def files have over 30 different protocols listed.  BUT, 
  994.         even though there are that many listed and available to RBBS-PC 
  995.         callers, most often only 5 to 10 are used on a given BBS system.  
  996.         PROANA will display up to 15 however.  As for the download sta
  997.         tistics chart, only the first 12 used protocols are shown, since 
  998.         more than that would 'trash' up the screen.  If enough users of 
  999.         PROANA request it, I will add a second chart screen that shows 
  1000.         another 12 download protocols.  So far though, I have not seen 
  1001.         any board where the users are actually using that many protocols 
  1002.         to download with.
  1003.         
  1004.           Finally, there is one change you should make to your PROTO.DEF 
  1005.         file in order to make it work correctly with PROANA.  That is to 
  1006.         remove (with most any ASCII text editor, or EDLIN.COM) any car-
  1007.         riage returns occurring right after the first field in each 
  1008.         record.  For instance, if your PROTO.DEF file looks like the 
  1009.         following:
  1010.                             "1) Ascii [RBBS internal]
  1011.                             ",0,IA,,,,,,0.92,,,,
  1012.         
  1013.         You should remove the carriage return so that it looks like this:
  1014.         
  1015.                     "1) Ascii [RBBS internal]",0,IA,,,,,,0.92,,,,
  1016.         
  1017.         There should be no leading space before the first character in 
  1018.         each line. I have included a copy of my PROTO.DEF that you may 
  1019.         either use or look at in order to get a better idea of what I 
  1020.         mean here.  If you use the PROTO.DEF file I have included, you 
  1021.         will have no problem, just remember, if you add another protocol, 
  1022.         don't add any carriage returns right after the first field.  A 
  1023.         later version of PROANA may eliminate the need for this.
  1024.         
  1025.         There are two .EXE files included with this package, do not try 
  1026.         to start the program with PROCALL.EXE, instead, use 
  1027.         PROANA.EXE.... PROCALL is called from the main menu when needed.       
  1028.         Finally, the only programs I am involved with are in support of 
  1029.         RBBS-PC, if you have any ideas, suggestions or thoughts for a 
  1030.         utility or stand alone program you think would enhance RBBS-PC, 
  1031.         please feel free to leave a note on the system and I will take it 
  1032.         into serious consideration. Thank you for using Proana, I am sure 
  1033.         it will help you with your system.
  1034.         
  1035.  
  1036.  
  1037.                                         15
  1038.                              ProAna For RBBS Ver. 17.4
  1039.  
  1040.  
  1041.         I would like to thank Jon Martin for his valuable suggestions 
  1042.         concerning this latest release, when I was really stuck trying to 
  1043.         figure a way around the PROTO.DEF problem.
  1044.         
  1045.         Special Thanks to co-authors, contributors and registered users:
  1046.         And Very Specially to :
  1047.         
  1048.                Loren Jones
  1049.                Jon Martin
  1050.                Richard Coutour
  1051.                Randy Sun
  1052.                Andrew Hoag
  1053.                Lee Nelson
  1054.                Jerry Sanders
  1055.                John Morrison
  1056.                And Many others
  1057.         
  1058.  
  1059.                      Richard Coutours'
  1060.                      San Francisco PC Users Group RBBS
  1061.                      1-415-621-2609
  1062.                      (San Francisci California)
  1063.  
  1064.                      Jon Martins' "Aircomm RBBS-PC"
  1065.                      1-510-689-2090
  1066.                      (Bay Area, California)
  1067.  
  1068.                      John Morrison's
  1069.                      Mailbox RBBS-PC
  1070.                      1-607-798-0315
  1071.                      (New York State)
  1072.  
  1073.                      Ken Goosens'
  1074.                      Your Place RBBS-PC
  1075.                      1-703-978-6360
  1076.                      (Fairfax, VA)
  1077.  
  1078.                      Doug Azzarito's
  1079.                      TCI Consultants RBBS-PC
  1080.                      1-407-487-3441
  1081.                      (Florida)
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.                                         16
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.                                         16
  1111.  
  1112.